<?php


/**
 * Base class that represents a query for the 'city' table.
 *
 * 
 *
 * @method     CityQuery orderByPostcode($order = Criteria::ASC) Order by the postcode column
 * @method     CityQuery orderByCityname($order = Criteria::ASC) Order by the cityname column
 *
 * @method     CityQuery groupByPostcode() Group by the postcode column
 * @method     CityQuery groupByCityname() Group by the cityname column
 *
 * @method     CityQuery leftJoin($relation) Adds a LEFT JOIN clause to the query
 * @method     CityQuery rightJoin($relation) Adds a RIGHT JOIN clause to the query
 * @method     CityQuery innerJoin($relation) Adds a INNER JOIN clause to the query
 *
 * @method     CityQuery leftJoinPerson($relationAlias = null) Adds a LEFT JOIN clause to the query using the Person relation
 * @method     CityQuery rightJoinPerson($relationAlias = null) Adds a RIGHT JOIN clause to the query using the Person relation
 * @method     CityQuery innerJoinPerson($relationAlias = null) Adds a INNER JOIN clause to the query using the Person relation
 *
 * @method     CityQuery leftJoinStation($relationAlias = null) Adds a LEFT JOIN clause to the query using the Station relation
 * @method     CityQuery rightJoinStation($relationAlias = null) Adds a RIGHT JOIN clause to the query using the Station relation
 * @method     CityQuery innerJoinStation($relationAlias = null) Adds a INNER JOIN clause to the query using the Station relation
 *
 * @method     City findOne(PropelPDO $con = null) Return the first City matching the query
 * @method     City findOneOrCreate(PropelPDO $con = null) Return the first City matching the query, or a new City object populated from the query conditions when no match is found
 *
 * @method     City findOneByPostcode(int $postcode) Return the first City filtered by the postcode column
 * @method     City findOneByCityname(string $cityname) Return the first City filtered by the cityname column
 *
 * @method     array findByPostcode(int $postcode) Return City objects filtered by the postcode column
 * @method     array findByCityname(string $cityname) Return City objects filtered by the cityname column
 *
 * @package    propel.generator.ise-php.om
 */
abstract class BaseCityQuery extends ModelCriteria
{
	
	/**
	 * Initializes internal state of BaseCityQuery object.
	 *
	 * @param     string $dbName The dabase name
	 * @param     string $modelName The phpName of a model, e.g. 'Book'
	 * @param     string $modelAlias The alias for the model in this query, e.g. 'b'
	 */
	public function __construct($dbName = 'ise-php', $modelName = 'City', $modelAlias = null)
	{
		parent::__construct($dbName, $modelName, $modelAlias);
	}

	/**
	 * Returns a new CityQuery object.
	 *
	 * @param     string $modelAlias The alias of a model in the query
	 * @param     Criteria $criteria Optional Criteria to build the query from
	 *
	 * @return    CityQuery
	 */
	public static function create($modelAlias = null, $criteria = null)
	{
		if ($criteria instanceof CityQuery) {
			return $criteria;
		}
		$query = new CityQuery();
		if (null !== $modelAlias) {
			$query->setModelAlias($modelAlias);
		}
		if ($criteria instanceof Criteria) {
			$query->mergeWith($criteria);
		}
		return $query;
	}

	/**
	 * Find object by primary key.
	 * Propel uses the instance pool to skip the database if the object exists.
	 * Go fast if the query is untouched.
	 *
	 * <code>
	 * $obj  = $c->findPk(12, $con);
	 * </code>
	 *
	 * @param     mixed $key Primary key to use for the query
	 * @param     PropelPDO $con an optional connection object
	 *
	 * @return    City|array|mixed the result, formatted by the current formatter
	 */
	public function findPk($key, $con = null)
	{
		if ($key === null) {
			return null;
		}
		if ((null !== ($obj = CityPeer::getInstanceFromPool((string) $key))) && !$this->formatter) {
			// the object is alredy in the instance pool
			return $obj;
		}
		if ($con === null) {
			$con = Propel::getConnection(CityPeer::DATABASE_NAME, Propel::CONNECTION_READ);
		}
		$this->basePreSelect($con);
		if ($this->formatter || $this->modelAlias || $this->with || $this->select
		 || $this->selectColumns || $this->asColumns || $this->selectModifiers
		 || $this->map || $this->having || $this->joins) {
			return $this->findPkComplex($key, $con);
		} else {
			return $this->findPkSimple($key, $con);
		}
	}

	/**
	 * Find object by primary key using raw SQL to go fast.
	 * Bypass doSelect() and the object formatter by using generated code.
	 *
	 * @param     mixed $key Primary key to use for the query
	 * @param     PropelPDO $con A connection object
	 *
	 * @return    City A model object, or null if the key is not found
	 */
	protected function findPkSimple($key, $con)
	{
		$sql = 'SELECT `POSTCODE`, `CITYNAME` FROM `city` WHERE `POSTCODE` = :p0';
		try {
			$stmt = $con->prepare($sql);			
			$stmt->bindValue(':p0', $key, PDO::PARAM_INT);
			$stmt->execute();
		} catch (Exception $e) {
			Propel::log($e->getMessage(), Propel::LOG_ERR);
			throw new PropelException(sprintf('Unable to execute SELECT statement [%s]', $sql), $e);
		}
		$obj = null;
		if ($row = $stmt->fetch(PDO::FETCH_NUM)) {
			$obj = new City();
			$obj->hydrate($row);
			CityPeer::addInstanceToPool($obj, (string) $key);
		}
		$stmt->closeCursor();

		return $obj;
	}

	/**
	 * Find object by primary key.
	 *
	 * @param     mixed $key Primary key to use for the query
	 * @param     PropelPDO $con A connection object
	 *
	 * @return    City|array|mixed the result, formatted by the current formatter
	 */
	protected function findPkComplex($key, $con)
	{
		// As the query uses a PK condition, no limit(1) is necessary.
		$criteria = $this->isKeepQuery() ? clone $this : $this;
		$stmt = $criteria
			->filterByPrimaryKey($key)
			->doSelect($con);
		return $criteria->getFormatter()->init($criteria)->formatOne($stmt);
	}

	/**
	 * Find objects by primary key
	 * <code>
	 * $objs = $c->findPks(array(12, 56, 832), $con);
	 * </code>
	 * @param     array $keys Primary keys to use for the query
	 * @param     PropelPDO $con an optional connection object
	 *
	 * @return    PropelObjectCollection|array|mixed the list of results, formatted by the current formatter
	 */
	public function findPks($keys, $con = null)
	{
		if ($con === null) {
			$con = Propel::getConnection($this->getDbName(), Propel::CONNECTION_READ);
		}
		$this->basePreSelect($con);
		$criteria = $this->isKeepQuery() ? clone $this : $this;
		$stmt = $criteria
			->filterByPrimaryKeys($keys)
			->doSelect($con);
		return $criteria->getFormatter()->init($criteria)->format($stmt);
	}

	/**
	 * Filter the query by primary key
	 *
	 * @param     mixed $key Primary key to use for the query
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function filterByPrimaryKey($key)
	{
		return $this->addUsingAlias(CityPeer::POSTCODE, $key, Criteria::EQUAL);
	}

	/**
	 * Filter the query by a list of primary keys
	 *
	 * @param     array $keys The list of primary key to use for the query
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function filterByPrimaryKeys($keys)
	{
		return $this->addUsingAlias(CityPeer::POSTCODE, $keys, Criteria::IN);
	}

	/**
	 * Filter the query on the postcode column
	 *
	 * Example usage:
	 * <code>
	 * $query->filterByPostcode(1234); // WHERE postcode = 1234
	 * $query->filterByPostcode(array(12, 34)); // WHERE postcode IN (12, 34)
	 * $query->filterByPostcode(array('min' => 12)); // WHERE postcode > 12
	 * </code>
	 *
	 * @param     mixed $postcode The value to use as filter.
	 *              Use scalar values for equality.
	 *              Use array values for in_array() equivalent.
	 *              Use associative array('min' => $minValue, 'max' => $maxValue) for intervals.
	 * @param     string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function filterByPostcode($postcode = null, $comparison = null)
	{
		if (is_array($postcode) && null === $comparison) {
			$comparison = Criteria::IN;
		}
		return $this->addUsingAlias(CityPeer::POSTCODE, $postcode, $comparison);
	}

	/**
	 * Filter the query on the cityname column
	 *
	 * Example usage:
	 * <code>
	 * $query->filterByCityname('fooValue');   // WHERE cityname = 'fooValue'
	 * $query->filterByCityname('%fooValue%'); // WHERE cityname LIKE '%fooValue%'
	 * </code>
	 *
	 * @param     string $cityname The value to use as filter.
	 *              Accepts wildcards (* and % trigger a LIKE)
	 * @param     string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function filterByCityname($cityname = null, $comparison = null)
	{
		if (null === $comparison) {
			if (is_array($cityname)) {
				$comparison = Criteria::IN;
			} elseif (preg_match('/[\%\*]/', $cityname)) {
				$cityname = str_replace('*', '%', $cityname);
				$comparison = Criteria::LIKE;
			}
		}
		return $this->addUsingAlias(CityPeer::CITYNAME, $cityname, $comparison);
	}

	/**
	 * Filter the query by a related Person object
	 *
	 * @param     Person $person  the related object to use as filter
	 * @param     string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function filterByPerson($person, $comparison = null)
	{
		if ($person instanceof Person) {
			return $this
				->addUsingAlias(CityPeer::POSTCODE, $person->getPostcode(), $comparison);
		} elseif ($person instanceof PropelCollection) {
			return $this
				->usePersonQuery()
				->filterByPrimaryKeys($person->getPrimaryKeys())
				->endUse();
		} else {
			throw new PropelException('filterByPerson() only accepts arguments of type Person or PropelCollection');
		}
	}

	/**
	 * Adds a JOIN clause to the query using the Person relation
	 *
	 * @param     string $relationAlias optional alias for the relation
	 * @param     string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function joinPerson($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
	{
		$tableMap = $this->getTableMap();
		$relationMap = $tableMap->getRelation('Person');

		// create a ModelJoin object for this join
		$join = new ModelJoin();
		$join->setJoinType($joinType);
		$join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias);
		if ($previousJoin = $this->getPreviousJoin()) {
			$join->setPreviousJoin($previousJoin);
		}

		// add the ModelJoin to the current object
		if($relationAlias) {
			$this->addAlias($relationAlias, $relationMap->getRightTable()->getName());
			$this->addJoinObject($join, $relationAlias);
		} else {
			$this->addJoinObject($join, 'Person');
		}

		return $this;
	}

	/**
	 * Use the Person relation Person object
	 *
	 * @see       useQuery()
	 *
	 * @param     string $relationAlias optional alias for the relation,
	 *                                   to be used as main alias in the secondary query
	 * @param     string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
	 *
	 * @return    PersonQuery A secondary query class using the current class as primary query
	 */
	public function usePersonQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
	{
		return $this
			->joinPerson($relationAlias, $joinType)
			->useQuery($relationAlias ? $relationAlias : 'Person', 'PersonQuery');
	}

	/**
	 * Filter the query by a related Station object
	 *
	 * @param     Station $station  the related object to use as filter
	 * @param     string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function filterByStation($station, $comparison = null)
	{
		if ($station instanceof Station) {
			return $this
				->addUsingAlias(CityPeer::POSTCODE, $station->getPostcode(), $comparison);
		} elseif ($station instanceof PropelCollection) {
			return $this
				->useStationQuery()
				->filterByPrimaryKeys($station->getPrimaryKeys())
				->endUse();
		} else {
			throw new PropelException('filterByStation() only accepts arguments of type Station or PropelCollection');
		}
	}

	/**
	 * Adds a JOIN clause to the query using the Station relation
	 *
	 * @param     string $relationAlias optional alias for the relation
	 * @param     string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function joinStation($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
	{
		$tableMap = $this->getTableMap();
		$relationMap = $tableMap->getRelation('Station');

		// create a ModelJoin object for this join
		$join = new ModelJoin();
		$join->setJoinType($joinType);
		$join->setRelationMap($relationMap, $this->useAliasInSQL ? $this->getModelAlias() : null, $relationAlias);
		if ($previousJoin = $this->getPreviousJoin()) {
			$join->setPreviousJoin($previousJoin);
		}

		// add the ModelJoin to the current object
		if($relationAlias) {
			$this->addAlias($relationAlias, $relationMap->getRightTable()->getName());
			$this->addJoinObject($join, $relationAlias);
		} else {
			$this->addJoinObject($join, 'Station');
		}

		return $this;
	}

	/**
	 * Use the Station relation Station object
	 *
	 * @see       useQuery()
	 *
	 * @param     string $relationAlias optional alias for the relation,
	 *                                   to be used as main alias in the secondary query
	 * @param     string $joinType Accepted values are null, 'left join', 'right join', 'inner join'
	 *
	 * @return    StationQuery A secondary query class using the current class as primary query
	 */
	public function useStationQuery($relationAlias = null, $joinType = Criteria::LEFT_JOIN)
	{
		return $this
			->joinStation($relationAlias, $joinType)
			->useQuery($relationAlias ? $relationAlias : 'Station', 'StationQuery');
	}

	/**
	 * Exclude object from result
	 *
	 * @param     City $city Object to remove from the list of results
	 *
	 * @return    CityQuery The current query, for fluid interface
	 */
	public function prune($city = null)
	{
		if ($city) {
			$this->addUsingAlias(CityPeer::POSTCODE, $city->getPostcode(), Criteria::NOT_EQUAL);
		}

		return $this;
	}

} // BaseCityQuery